.TH APLAYMIDI 1 "2 Nov 2011"

.SH NAME
aplaymidi \- play Standard MIDI Files

.SH SYNOPSIS
.B aplaymidi
\-p client:port[,...] [\-d delay] midifile ...

.SH DESCRIPTION
.B aplaymidi
is a command-line utility that plays the specified MIDI file(s) to one
or more ALSA sequencer ports.

.SH OPTIONS

.TP
.I \-h, \-\-help
Prints a list of options.

.TP
.I \-V, \-\-version
Prints the current version.

.TP
.I \-l, \-\-list
Prints a list of possible output ports.

.TP
.I \-p, \-\-port=client:port,...
Sets the sequencer port(s) to which the events in the MIDI file(s) are
sent.

.TP
.I \-u, \-\-ump=version
Changes the sequencer client to the given MIDI version and outputs via
the UMP packets instead of legacy sequencer events.
As of now, the only supported version is 1.

A client can be specified by its number, its name, or a prefix of its
name. A port is specified by its number; for port 0 of a client, the
":0" part of the port specification can be omitted.

Multiple ports can be specified to allow playback of MIDI file(s) that
contain events for multiple devices (ports), as specified by "Port
Number" meta events.

For compatibility with
.B pmidi(1),
the port specification is taken from the
.I ALSA_OUTPUT_PORTS
environment variable if none is given on the command line.

.TP
.I \-d, \-\-delay=seconds
Specifies how long to wait after the end of each MIDI file,
to allow the last notes to die away.

.SH BUGS
.B aplaymidi
handles "Port Number" meta events, but not "Port Name" meta events.

.SH SEE ALSO
pmidi(1)
.br
playmidi(1)

.SH AUTHOR
Clemens Ladisch <clemens@ladisch.de>
